Inside Macintosh: QuickDraw GX Objects /

Chapter 4 - Colors and Color-Related Objects / Colors and Color-Related Objects Reference

Color Set Functions / Creating and Manipulating Color Set Objects

GXSetDefaultColorSet

You can use the GXSetDefaultColorSet function to replace the default color set object for a particular pixel depth.

void GXSetDefaultColorSet(gxColorSet target, long pixelDepth);

target

A reference to the color set object to make the new default.

pixelDepth

The pixel size of the color set.

DESCRIPTION

The GXSetDefaultColorSet function replaces an existing default color set with the color set specified by the target parameter. The pixel depth of the target color set determines which default color set is replaced.

This function disposes of the old default color set and increments the owner count of the new default color set.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
colorSet_is_nil
invalid_colorSet_count	(debugging version)
invalid_pixelSize	(debugging version)

SEE ALSO

Default color set objects are discussed in the section "Default Color Sets" on page 4-34. To obtain a copy of a default color set object, use the GXGetDefaultColorSet function, described in the previous section.

To create a new color set object, use the GXNewColorSet function, described next.